"""Help strings for open."""

command = """\
The command to execute this application.

The standard mode is the simplest: whitespace separates the command
an any arguments, the file name will be appended to the list, and the
entire thing passed to the OS. No shell processing is done at all.

Single substitution mode is enabled if a %s appears anywhere in the
command. In this case the file name will be quoted to guard special
characters from interpretation by the shell, and then substituted in
place of the %s. To put a % in the command, use %%. The resulting
string will be passed to the shell.  If you need shell processing -
I/O redirection, pipes, etc. - you can use a %s even if the command
could be formatted properly in the standard mode.
"""

name = """\
The name used in the UI for the application.

Currently, the only place this is used is with the "--application" flag
to the open command.
"""

flags = """\
The flags that describe this application.

This is a white-space separated list of flags describing the application
and the action that it takes. Currently recognized flags are: open:
This application will display the file. edit: This application will edit
the file. print: This application will print the file (NOT IMPLEMENTED YET).
X: Must run in an X environment. noX: Must run in a terminal environment.
convert: This application will create a new file of a different type.
<extension>: Used in conjunction with the convert flag to specify the type
that this application will create.

Flags is case-insensitive.
"""

extensions = """\
The extensions that this applications recognize.

This is a white-space separated list of extension that this application
can handle. They should not include the ".".

Extensions is case-insensitive.
"""
